home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 March / EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso / earcd / music / mdtls127.lha / ModUtils.doc < prev    next >
Text File  |  1996-02-07  |  27KB  |  657 lines
  1.         |\    /|  ___   ___   |   | _____         ____
  2.         | \  / | /   \ |   \  |   |   |   | |    (
  3.         |  \/  |(     )|    ) |   |   |   | |     ¯-_
  4.         |      | \___/ |___/  \___/   |   | |___ ____)
  5.  
  6.            by Ben Hutchings  release 1.27  7 February 1996
  7.  
  8.            ModPlay 2.10 · ModRip 1.1 · ModAlloc 1.3
  9.                MakeRipperDisk 1.0 · ModWipe 1.0
  10.  
  11.  
  12.   LEGAL INFORMATION
  13.  
  14.   All trademarks referred  to herein are the properties  of their respective
  15.   owners.
  16.  
  17.   DISTRIBUTION
  18.  
  19.   The contents of the 'ModUtils' package are the files:
  20.  
  21.       Install ModUtils    Install ModUtils.info
  22.       Install ReqTools    Install ReqTools.info
  23.       MakeRipperDisk      MakeRipperDisk.info
  24.       ModAlloc            ModAlloc.info
  25.       ModPlay             ModPlay.info
  26.       ModRip              ModRip.info
  27.       ModUtils.doc        ModUtils.doc.info
  28.       ModUtils.guide      ModUtils.guide.info
  29.       ModWipe             ModWipe.info
  30.  
  31.   These files  are all copyright  © Ben Hutchings  1995. They may  freely be
  32.   distributed provided
  33.  
  34.   (i)   no  charge  is  made  for  this  above  the  costs  of  duplication,
  35.     distribution and the media used,
  36.   (ii)  all the aforementioned files are distributed together, and
  37.   (iii) none  of  the  aforementioned  files  are altered,  except,  if  the
  38.     distributor  so wishes, by  converting them  into a  compressed form
  39.     from which they can be retrieved unaltered.
  40.  
  41.   Software released under these conditions is often known as Freeware.
  42.  
  43.   The file 'reqtools.library'  is intended to be included  with this package
  44.   but I do  not hold the copyright to  this file and so I have  no right nor
  45.   intention to restrict its use or distribution.
  46.  
  47.   DISCLAIMER
  48.  
  49.   This software and documentation is provided 'as-is' without representation
  50.   or  warranty of  any kind,  either express  or implied,  including without
  51.   limitation, any representations or  endorsements regarding the use of, the
  52.   results of,  or the performance  of the information,  its appropriateness,
  53.   accuracy, reliability,  or currentness; the entire  risk as to  the use of
  54.   this information is assumed by the user.
  55.  
  56.   In  no  event  shall  I  be  liable for  any  damages,  direct,  indirect,
  57.   incidental or consequential, resulting from any defect in the information,
  58.   even if I have been advised of the possibility of such damages.
  59.  
  60.   THIRD PARTY COPYRIGHT
  61.  
  62.   I neither condone nor authorise  the use of my software, specifically, the
  63.   program 'ModRip',  for the illegal reproduction of  copyright material. It
  64.   is illegal to  make copies, even for your own  use, of copyright material,
  65.   without the express permission of  the copyright owner, or as permitted by
  66.   the license thereof.
  67.  
  68.  
  69.   INTRODUCTION
  70.  
  71.   If  you aren't  familiar with  music modules,  you should  first  read the
  72.   section which explains a bit about them.
  73.  
  74.   If you  are familiar with the ModUtils  package, you may want  to read the
  75.   release history for a summary of changes.
  76.  
  77.   The ModUtils package consists of a  module player - ModPlay - and a module
  78.   ripper - ModRip - plus a few extra bits of software to support them.
  79.  
  80.   I  wrote  these  programs   after  finding  my  existing  module  software
  81.   inadequate and out-dated. I hope you find them as useful as I have. If you
  82.   find these inadequate or out-dated then I'm very sorry!
  83.  
  84.  
  85.   MODUTILS HISTORY
  86.  
  87.   release 1.27, 7 February 1996
  88.  
  89.       ModPlay 2.10,  ModRip 1.1,  ModAlloc 1.3, MakeRipperDisk  1.0, ModWipe
  90.       1.0
  91.  
  92.   release 1.26, 25 January 1996
  93.  
  94.       ModPlay 2.9, ModRip 1.1, ModAlloc 1.3, MakeRipperDisk 1.0, ModWipe 1.0
  95.  
  96.   release 1.25, 14 August 1995
  97.  
  98.       ModPlay 2.8, ModRip 1.1, ModAlloc 1.3, MakeRipperDisk 1.0, ModWipe 1.0
  99.  
  100.   release 1.24, 1 August 1995
  101.  
  102.       ModPlay 2.7, ModRip 1.1, ModAlloc 1.3, MakeRipperDisk 1.0, ModWipe 1.0
  103.       You may notice  that ModAlloc seems to have  jumped straight from v1.0
  104.       to v1.3. This is because the version included in previous releases was
  105.       actually v1.2 (see ModAlloc history).
  106.  
  107.   release 1.23, July 1995
  108.  
  109.       ModPlay 2.7, ModRip 1.1, ModAlloc 1.2, MakeRipperDisk 1.0, ModWipe 1.0
  110.  
  111.   release 1.22, June 1995
  112.  
  113.       ModPlay 2.6, ModRip 1.1, ModAlloc 1.2, MakeRipperDisk 1.0, ModWipe 1.0
  114.  
  115.   release 1.21, May 1995
  116.  
  117.       ModPlay 2.5, ModRip 1.1, ModAlloc 1.2, MakeRipperDisk 1.0, ModWipe 1.0
  118.     · Improved documentation,  thanks partly to a text  formatting program I
  119.       just wrote.
  120.  
  121.   release 1.2, May 1995
  122.  
  123.       ModPlay 2.4, ModRip 1.1, ModAlloc 1.2, MakeRipperDisk 1.0, ModWipe 1.0
  124.  
  125.   release 1.1, November 1994
  126.  
  127.       ModPlay 2.3  & 1.0, ModRip  1.0, ModAlloc 1.2, InstallBB  1.0, ModWipe
  128.       1.0
  129.  
  130.   release 1.0, October 1994
  131.  
  132.       ModPlay 2.2  & 1.0, ModRip  1.0, ModAlloc 1.2, InstallBB  1.0, ModWipe
  133.       1.0
  134.  
  135.  
  136.   ABOUT MODULES
  137.  
  138.   Music modules are files containing  descriptions of one or more sounds and
  139.   a  list of  notes  and effects  to play  with  them. One  of the  earliest
  140.   programs to produce music  modules was Soundtracker, which produced simple
  141.   files  containing sampled  waveforms  (that is,  digital  records of  real
  142.   instruments and noises) plus a number  of blocks of note codes, and a list
  143.   defining  the order  they should  be played  in (so  that blocks  could be
  144.   repeated).
  145.  
  146.   Then a program  called Noisetracker was released which  had added features
  147.   and used  roughly the same file format,  so that it could  read in modules
  148.   produced by Soundtracker. Since  then numerous improved versions have been
  149.   produced  and Soundtracker has  been replaced  by Protracker.  Despite all
  150.   these  changes the file  format has  remained the  same except  that extra
  151.   codes  for the  new musical  effects have  been added.  So there  are huge
  152.   numbers of modules  out there which can all be handled  by the same player
  153.   program. Not  only this,  but the  same file format  is also  supported by
  154.   software  on the  PC and  Archimedes, and  maybe some  other  computers. A
  155.   friend of  mine has hundreds of modules  of this type on  PC CD-ROM. Using
  156.   DOS2DOS, MessyDOS, or CrossDOS then you  will be able to use these modules
  157.   as well as those on normal Amiga disks!
  158.  
  159.   Many demos and games use  Soundtracker or compatible modules because it is
  160.   much  easier to  use a  standard program  to make  music than  to  write a
  161.   special routine  for each tune. So  if you can  get the module out  of the
  162.   game (a process known as 'ripping')  then you can listen to your favourite
  163.   game tunes  while doing something  else like word-processing or  writing a
  164.   program. However, please note the legal implications of this.
  165.  
  166.   The limitation  of ripping is  this: unless you  have an Action  Replay or
  167.   similar cartridge, you can't actually stop the game while it's running and
  168.   rip out  data without disturbing  anything. Nevertheless, I have  found my
  169.   ripper software to be very effective.
  170.  
  171.   Included in  this package  are a module  player -  ModPlay - and  a module
  172.   ripper - ModRip - plus a few extra bits of software to support them.
  173.  
  174.  
  175.   INSTALLATION
  176.  
  177.   You do not need  to install any of the programs in  order to use them, but
  178.   you may find it useful to do so if you have a hard drive.
  179.  
  180.   If  you have  Commodore's Installer  program,  all you  need to  do is  to
  181.   double-click the 'Install ModUtils'  icon then follow the instructions you
  182.   are given.  If you aren't  sure whether you  have the program,  there's no
  183.   harm in trying this anyway.
  184.  
  185.   If you  don't have Installer, then you  will have to copy  the programs to
  186.   your hard drive by dragging their icons or by using the Shell. (To install
  187.   all the  programs you  can simply  drag the drawer  icon.) If  you install
  188.   ModPlay  individually, manually,  please refer  to the  section concerning
  189.   reqtools.library, which is required to provide full functionality.
  190.  
  191.  
  192.   REQTOOLS
  193.  
  194.   Reqtools.library  is  a  set  of  programmers' routines  created  by  Nico
  195.   François for use  on the Amiga. ModPlay uses it  to create file requesters
  196.   and  error requesters,  so you  should have  it installed  on  your system
  197.   before using ModPlay.
  198.  
  199.   If you use  the 'Install ModUtils' icon to install  ModPlay then this will
  200.   be done automatically. If you  carry out a manual installation, you should
  201.   then  check whether you  have a  copy of  reqtools.library by  running the
  202.   installed copy  of ModPlay from Workbench  to see whether it  works. If it
  203.   produces an error, then you should install ReqTools on your system disk or
  204.   partition by double-clicking the 'Install ReqTools' icon on the Workbench.
  205.  
  206.   Note that reqtools.library is copyright © Nico François.
  207.  
  208.  
  209.   MODPLAY
  210.  
  211.   Those familiar with  ModPlay might want to read the  release history for a
  212.   summary of changes.
  213.  
  214.   ModPlay is a simple module player based on the Protracker playroutine. The
  215.   advantages it has over other module players are these:
  216.  
  217.   · It's very small.
  218.   · It can be made resident in memory for Shell use.
  219.   · It can stop music automatically instead of looping.
  220.   · It uses ReqTools (thanks to Nico François).
  221.   · It uses reliable CIA timing  so the speed is correct whatever screenmode
  222.     you are using.
  223.   · You can stop or change  the music being played simply by running ModPlay
  224.     again.
  225.  
  226.   One of the reasons I had for writing this was for use in disk magazines (I
  227.   was hoping to produce one myself  but that will have to wait). Although it
  228.   can  be run  from  Workbench, ModPlay  is  designed for  control by  Shell
  229.   commands and especially by scripts.
  230.  
  231.   Note  that you must  have reqtools.library  version 38  or better  in your
  232.   LIBS: directory  if you want to  run it from  the Workbench or use  a file
  233.   requester to select music modules.
  234.  
  235.   ModPlay can  automatically detect and  decompress modules packed  with the
  236.   PowerPacker routines, but to do so it requires "powerpacker.library" to be
  237.   present  in the LIBS:  directory. This  can be  found in  many PD/freeware
  238.   distributions, on coverdisks, and in  the full PowerPacker package, or via
  239.   the Internet in Aminet archive util/libs/pplib16.lha.
  240.  
  241.  
  242.   Shell usage:
  243.   ¯¯¯¯¯¯¯¯¯¯¯¯
  244.   For  full functionality  from  a  Shell under  1.3,  ModPlay requires  the
  245.   arp.library. If arp.library  is not available, ModPlay will  only play one
  246.   named module or  display a requester. All text  following the command name
  247.   and the space after it will be regarded as a filename, though for the sake
  248.   of compatibility  any quotes  around the filename  will be ignored.  If no
  249.   arguments are given a requester will appear.
  250.  
  251.   To start playing a module, or to change some music already playing, type
  252.  
  253.       ModPlay <file> [LOOP]
  254.  
  255.   where  <file>  represents the  filename  of the  module,  and  LOOP is  an
  256.   optional switch. Multiple  files can be supplied, and  they will be played
  257.   in the order specified. If a  single file is specified and the LOOP switch
  258.   is used, the file  will be played in a loop until  it is stopped manually.
  259.   If  the LOOP switch  is used  with more  than one  file, ModPlay  will run
  260.   through the sequence of files repeatedly until it is stopped manually.
  261.  
  262.   To stop the music prematurely, or to stop a looping piece of music, type
  263.  
  264.       ModPlay STOP
  265.  
  266.   To use a file requester to start/stop music, just type
  267.  
  268.       ModPlay
  269.  
  270.   then pick a module or click Cancel to stop. The requester will keep coming
  271.   back when each piece of music finishes, until you click Cancel.
  272.  
  273.   You  can  also  stop a  single  module  by  pressing  Ctrl-C, or  you  can
  274.   completely exit the program by pressing Ctrl-D.
  275.  
  276.   If you  intend to use  ModPlay in a  script, please see the  separate note
  277.   concerning this.
  278.  
  279.  
  280.   Workbench usage:
  281.   ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  282.   There are three possible ways to start ModPlay from the Workbench.
  283.  
  284.   1. If your  modules are saved with  icons, you can set  their default tool
  285.      (using  the   Workbench  'Information'  function)   to  something  like
  286.      'Work:ModUtils/ModPlay'  (this setting  would  be correct  if you  have
  287.      installed  ModUtils  on a  partition  called  'Work').  Then, when  you
  288.      double-click them, ModPlay will be loaded and will then play them.
  289.   2. If  your modules have  icons, you  can use  extended selection  to play
  290.      them. What  this means is, select  the first one, then  hold down Shift
  291.      and  select any  others, then  (keeping Shift  held  down) double-click
  292.      ModPlay's icon.
  293.   3. Double-click the ModPlay icon. A file requester will appear. Select the
  294.      drawer your modules are stored in. Then select a module and click OK.
  295.      The requester will re-appear when the module(s) stop. You can then stop
  296.      by  clicking Cancel  or  select a  module  or modules  again  to go  on
  297.      playing.
  298.  
  299.   You can stop a module before  its natural end by starting ModPlay from its
  300.   icon and clicking Cancel.
  301.  
  302.  
  303.   NOTE: USING MODPLAY IN SCRIPTS
  304.  
  305.   If you use  ModPlay in a script  for a disk magazine or  similar, you will
  306.   need to run  ModPlay in 'background' with the Run command.  If you want to
  307.   put something like
  308.  
  309.       ModPlay intro.mod
  310.  
  311.   in a startup-sequence, e.g.
  312.  
  313.       Echo "Welcome to XYZ disk magazine issue #5!"
  314.       ModPlay intro.mod
  315.       LoadWB
  316.       EndCLI >NIL:
  317.  
  318.   you will actually need to use the command
  319.  
  320.       Run >NIL: <NIL: ModPlay >NIL: <NIL: intro.mod
  321.  
  322.   otherwise the  Shell window will  just stay on  the screen and  do nothing
  323.   until the music finishes.
  324.  
  325.   If ModPlay is asked to STOP and there isn't actually any music playing, it
  326.   will return code 5 (WARN) in case you want your script to check for this.
  327.   Obviously if something else goes wrong it will return code 20 (FAIL) which
  328.   will terminate  your script  unless you use  the Failat command  (see your
  329.   Commodore manual for details) to prevent this.
  330.  
  331.  
  332.   MODPLAY HISTORY
  333.  
  334.   version 2.10, 7 February 1996
  335.  
  336.     · Got  rid of  the irritating  high-pitched noises  which  sometimes got
  337.       played when  a sample ended.  These appeared when  playing non-looping
  338.       samples  which didn't  have zero  in  their first  two bytes,  because
  339.       `non-looping' samples are  actually set to have loop  start 0 and loop
  340.       length 2 bytes. Now a dummy zero  sample will play as the loop part of
  341.       such samples.
  342.  
  343.   version 2.9, 25 January 1996
  344.  
  345.     · PowerPacker decompression added.
  346.     · Error reporting improved and debugged (I hope).
  347.     · More  tolerant of  modules with  incorrect lengths,  as produced  by a
  348.       number of Trackers.
  349.  
  350.   version 2.8, 14 August 1995
  351.  
  352.     · Double-quotes are now  handled consistently even in the  absence of OS
  353.       2.0+  and arp.library.  I felt  that the  approach introduced  in v2.4
  354.       seriously  damaged the  program's compatibility  in  automated systems
  355.       e.g. scripts.
  356.     · Really fixed  library opening - now  the LIBS: directory  is looked in
  357.       first,  followed by  the  current directory  (CLI)  or tool  directory
  358.       (Workbench).
  359.  
  360.   version 2.7, 31 July 1995
  361.  
  362.     · There was a  really stupid bug introduced in v2.5  which meant that if
  363.       you started one  copy of ModPlay with a requester,  then tried to play
  364.       something with a second copy, not  only would the second copy stop the
  365.       first (as expected) but the first would then stop the second (whoops!)
  366.       Fixed.
  367.  
  368.   version 2.6, 16 June 1995
  369.  
  370.     · Fixed  a  couple  of  bugs  I  rather  stupidly  introduced  into  the
  371.       playroutine. Songs with arpeggios in will no longer crash now!
  372.     · If the loop switch is used  with multiple files, the sequence of files
  373.       will be looped rather than each individual file.
  374.     · Fixed a small  bug in the library opening  which probably never caused
  375.       any trouble.
  376.     · I got  fed up with  the pickiness over  module size, so now  any extra
  377.       bytes on the end of a module will just be ignored.
  378.  
  379.   version 2.5, 30 May 1995
  380.  
  381.     · Put back the code to open  libraries in the current directory (as used
  382.       in version 1.0).
  383.     · If ARP command  line parsing fails, the ARP error  message is now used
  384.       instead of unhelpfully reporting 'unknown error'.
  385.     · Rewrote some  of the  C code in  assembler to  save on code  size, and
  386.       removed  a few  bits of  code which  never actually  got  called. Also
  387.       optimised the playroutine a bit more.
  388.     · Requester now  no longer re-appears  if instructed to stop  by another
  389.       copy of ModPlay (this bug only appeared in v2.4!)
  390.     · Under OS 1.x you  can now play one module or use  a requester from the
  391.       CLI without arp.library (as was possible before v2.4!)
  392.     · A  potentially nasty  bug  introduced into  the  playroutine has  been
  393.       removed. I don't think it would ever have caused any problems though.
  394.  
  395.   version 2.4, 11 May 1995
  396.  
  397.     ·  Unified  the  two versions  for  OS  1.x  and  OS  2.0+, so  all  the
  398.       improvements made  since version 1.0  can now be enjoyed  by everyone.
  399.       Actually, version  1.0, which was first released  as ModPlay13, didn't
  400.       work at all (reported by  Alan Pfeil). Strangely, the preliminary v1.0
  401.       I made  two days earlier, which  I myself still had  installed, did. I
  402.       can't find an explanation for any of this strangeness.
  403.     · Arp.library is  now required for Shell use under OS  1.x (but see note
  404.       for v2.5)
  405.     · Reqtools.library  is not  opened unless and  until any  requesters are
  406.       required  (suggested  by Alan  Pfeil).  This  means  that if  no  user
  407.       intervention is required (e.g. you  are putting ModPlay in a script on
  408.       a self-booting disk), reqtools.library does not need to be available.
  409.  
  410.   version 2.3, November 1994
  411.  
  412.     · Fixed a  bug in the code for changing directories  - the program often
  413.       (usually?) failed inexplicably if started from the Workbench.
  414.  
  415.   version 2.2, September 1994
  416.  
  417.       First public release.
  418.  
  419.   versions 2.0-2.1, 1994
  420.  
  421.       Not released.
  422.  
  423.   version 1.0, 1993
  424.  
  425.       Released along with v2.2 in ModUtils r1.0, as ModPlay13.
  426.  
  427.  
  428.   MODRIP
  429.  
  430.   Those familiar  with ModRip might want  to read the release  history for a
  431.   summary of changes.
  432.  
  433.   ModRip  is a  simple module  ripper.  This means  that it  is designed  to
  434.   identify any Soundtracker or compatible modules in memory, calculate their
  435.   size, and save them to disk.
  436.  
  437.   Despite  this apparently  rather dodgy  mode  of operation,  it should  be
  438.   completely system-legal as  it only reads memory within  the bounds of the
  439.   memory blocks listed as public memory. This will cause problems if you try
  440.   running  the  program 'Mungwall'  at  the same  time.  It  may also  cause
  441.   problems with  'Enforcer' but I don't  know since I'm not  quite sure what
  442.   Enforcer does. If so, please tell me.
  443.  
  444.   It isn't 100% reliable as most games and demos bypass the operating system
  445.   and so  are liable to  have their data  corrupted (i.e. destroyed)  in the
  446.   period between  exiting the  program and running  ModRip. Also  some games
  447.   intercept  resets and  clear  their  data in  memory  to prevent  ripping.
  448.   Besides which, not  all game music will be  stored in Soundtracker format.
  449.   Note that  I have also  produced a  ripper for MED  modules as part  of my
  450.   MEDUtils package, which may accompany this.
  451.  
  452.   The   effectiveness  of  ModRip   can  be   improved  using   ModAlloc  or
  453.   MakeRipperDisk.
  454.  
  455.   Please note that ripping is not always legal.
  456.  
  457.  
  458.   Shell usage:
  459.   ¯¯¯¯¯¯¯¯¯¯¯¯
  460.   To begin searching for modules, type
  461.  
  462.       ModRip
  463.  
  464.   and  wait. When  a module  is found,  brief information  about it  will be
  465.   displayed in the window. If this  is gibberish then don't bother saving it
  466.   - most  modules contain  some meaningful  text which you  will be  able to
  467.   read.   To    save   the   module,    type   in   a   filename    -   e.g.
  468.   DF0:NiceRayTracedDemoTune  - and  press  Return. To  skip  it, just  press
  469.   Return.
  470.  
  471.   When the search is finished, a Shell prompt will reappear.
  472.  
  473.  
  474.   Workbench usage:
  475.   ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  476.   Double-click the ModRip icon.
  477.   When a module is found, brief  information about it will be displayed in a
  478.   window. If  this is  gibberish then don't  bother saving it!  Most modules
  479.   contain  meaningful text  which you  will  be able  to read.  To save  the
  480.   module, type  in a filename  - e.g. DF0:NiceRayTracedDemoTune -  and press
  481.   Return. To skip it, just press Return.
  482.  
  483.   When the search is finished, the window will disappear.
  484.  
  485.  
  486.   MODRIP HISTORY
  487.  
  488.   version 1.1, May 1995
  489.  
  490.     · Although ModRip  never used any OS 2.0  functions, the mode previously
  491.       used to open an output window when ModRip is started from Workbench is
  492.       not supported by OS 1.x!  This made the window close immediately. This
  493.       has been fixed.
  494.  
  495.   version 1.0, August 1994
  496.  
  497.       First public release.
  498.  
  499.  
  500.   MODALLOC
  501.  
  502.   Those familiar with ModAlloc might want  to read the release history for a
  503.   summary of changes.
  504.  
  505.   This program installs  a special 'KickTag' which is  run immediately after
  506.   any reset.  The KickTag code will  find any Tracker modules  in memory and
  507.   allocate the memory they use so that they are protected from being written
  508.   over. This means  that you can rip many modules  which you might otherwise
  509.   not be able to.
  510.  
  511.   To  run it,  simply double-click  the ModAlloc  icon or  use the  Shell. A
  512.   message will appear telling you to  reboot when ready. This means that you
  513.   can now run whatever program/game/demo you  want to rip music out of, then
  514.   reset the computer when the music you want is playing.
  515.   Once ModAlloc has been run, every time you reset, the screen will start to
  516.   strobe slowly.  At this point  you should press  the LEFT mouse  button to
  517.   start searching for  modules or the RIGHT mouse button  to bypass this and
  518.   reboot normally.
  519.  
  520.   If you press the left button, the screen will immediately turn red. If and
  521.   when a  module is found it  will turn blue until  it finds the  end of the
  522.   module, when it will briefly  flash yellow. This may happen several times.
  523.   Be  patient! The  process should  take  a maximum  of 5  seconds for  each
  524.   megabyte of memory switched on; if it takes much longer than this, you can
  525.   press the RIGHT mouse button to exit.
  526.   Once the  procedure has finished  or you press  the right mouse  button to
  527.   exit, the computer will boot up as  normal. You can then run ModRip to rip
  528.   the modules as described above.
  529.  
  530.   Note that  some programs  may completely tear  down the  operating system,
  531.   which  means the  'KickTag' code  will  no longer  be found  and will  not
  532.   operate when you reset. In this case you should use MakeRipperDisk.
  533.  
  534.  
  535.   MODALLOC HISTORY
  536.  
  537.   version 1.3, August 1995
  538.  
  539.     · It works!  And it's  also faster and  more reliable than  the original
  540.       version.
  541.  
  542.   version 1.2, August 1994
  543.  
  544.     · Erm, don't know what improvements I  was trying to make here. This was
  545.       the first released version. Unfortunately, it didn't work.
  546.  
  547.   version 1.1, July 1994
  548.  
  549.     · Some improvements on v1.0, I guess. I can't remember that far back.
  550.  
  551.   version 1.0, July 1994
  552.  
  553.       First version.
  554.  
  555.  
  556.   MAKERIPPERDISK
  557.  
  558.   This program makes  a special bootable disk which  should provide the best
  559.   environment for ripping modules.
  560.  
  561.   Just find a blank disk (no need to format it) and run the 'MakeRipperDisk'
  562.   program either  from the Shell  or by double-clicking its  Workbench icon.
  563.   Then,  when you  are asked  to, insert  the blank  disk and  press Return.
  564.   Within about a  minute your disk (which will now  be called 'ModRip') will
  565.   be ready. I  should mention that the counter  for the formatting procedure
  566.   counts  tracks  and not  cylinders,  so  it will  count  up  to  159 on  a
  567.   double-density disk or 319 on a high-density disk. Do not be alarmed! Note
  568.   that I  cannot test the program with  high-density disks so I  do not know
  569.   for sure  whether it will work correctly  with them; please tell  me if it
  570.   doesn't.
  571.  
  572.   To use the ripper disk, first turn off all unneeded drives, then reset the
  573.   computer and run the program/game/demo you  want to rip music out of. Then
  574.   reset again and  quickly insert the ripper disk in  the internal drive (do
  575.   NOT wait for the nice picture of a disk to appear!). The screen will start
  576.   to strobe slowly. At this point  you should press the LEFT mouse button to
  577.   start searching for modules. The screen  will then turn red. If and when a
  578.   module is found  it will turn blue  until it finds the end  of the module,
  579.   when  it will  briefly flash  yellow. This  may happen  several  times. Be
  580.   patient!
  581.  
  582.   The process should take a maximum of 5 seconds for each megabyte of memory
  583.   switched on;  if it takes much longer  than this, you can  press the RIGHT
  584.   mouse button  to exit. Once  the procedure has  finished or you  press the
  585.   right mouse button to exit, the computer will boot up as normal and ModRip
  586.   will load. There will  be plenty of space on the disk  to save any modules
  587.   which are found.
  588.  
  589.  
  590.   MODWIPE
  591.  
  592.   This tiny  utility just wipes out any  modules in memory so  that they are
  593.   invisible to  ModAlloc and the  ripper disks made with  MakeRipperDisk and
  594.   won't take up any valuable memory. It will then reboot, freeing all memory
  595.   and allowing you to restart with all your memory available.
  596.  
  597.   It will take a little while before it resets to check all through memory -
  598.   a maximum  of 5 seconds  for each megabyte  of memory switched  on. During
  599.   this time nothing will seem to be happening - this is normal.
  600.  
  601.   WARNING: Before  running ModWipe you should  ensure that any  data you are
  602.   working  on is  saved  to disk,  and  that all  disk  access has  stopped.
  603.   Otherwise you could lose your work or worse still corrupt a disk!
  604.  
  605.   Shell Usage:
  606.   ¯¯¯¯¯¯¯¯¯¯¯¯
  607.       ModWipe
  608.  
  609.   Workbench usage:
  610.   ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  611.       Double-click the ModWipe icon.
  612.  
  613.  
  614.   ACKNOWLEDGEMENTS
  615.  
  616.   I  owe the  main  player routine  mainly  to Lars  'Zap'  Hamre and  Amiga
  617.   Freelancers -  and if  you're out there  somewhere, please, please,  can I
  618.   have a well-commented up-to-date routine  because this one dates from 1991
  619.   and I had  to spend months hacking  at it just so that  I could understand
  620.   it, after which it needed a number of enhancements to handle the modules I
  621.   threw at it.  Mind you, I'm not much good at  writing in assembly language
  622.   anyway and custom hardware was a complete mystery to me before I read this
  623.   code.
  624.  
  625.   Thanks   to  Nico   François  for   reqtools.library  and   its  excellent
  626.   documentation, which is, like the library itself, freeware.
  627.  
  628.   I must also thank Alan Pfeil of ICPUG for drawing my attention to a number
  629.   of serious bugs in earlier versions of ModPlay.
  630.  
  631.                //
  632.   Finally, thanks to \X/ Amiga for being the best.
  633.  
  634.  
  635.   HOW AND WHY TO CONTACT ME
  636.  
  637.   Please write to  me if you have any comments,  suggestions, bug reports or
  638.   programming hints to make. I would especially like to hear from anyone who
  639.   can supply
  640.      · some 'official' tracker specifications
  641.   or · a  new  playroutine (I  am  currently  using  a modified  version  of
  642.        Protracker 1.1B VBlank)
  643.   or · any reports of Enforcer hits (well I don't exactly want to hear these
  644.        but if there is a problem I ought to know)
  645.  
  646.   Snail mail:
  647.                   Ben Hutchings
  648.                   43 Harrison Close
  649.                   Reigate
  650.                   Surrey RH2 7HS
  651.                   ENGLAND
  652.  
  653.           E-mail (Internet): benjamin.hutchings@worc.ox.ac.uk
  654.  
  655.   For up-to-date information on ModUtils and other software by me see my web
  656.             page: http://sable.ox.ac.uk/~worc0223
  657.